home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 44 / Amiga Format CD44 (1999-08-26)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-10].iso / -in_the_mag- / basics / amos / artcoder.lha / ArtCoder / AC.ReadMe next >
Text File  |  1996-01-12  |  6KB  |  165 lines
  1.  
  2.  AMOS ART CODER © 1993,1996 Steve Tiffany -- Freeware
  3.  
  4.    AMOS Art Coder is a program which simplifies the use
  5.    of the graphics commands Polygon, Polyline, Draw, Box
  6.    Bar, Ellipse, Paint, Palette, Set Pattern and Text.
  7.    It works like a paint program, but instead of saving 
  8.    a picture as an IFF file, it writes an Ascii file in
  9.    RAM that contains the code to re-create the drawing.
  10.    You simply merge this code into your own program
  11.    where you want the picture to draw.
  12.  
  13.    In light of AMOS's superior handling of bobs and IFF 
  14.    files, why do you need something like this?  
  15.  
  16.    There are times when you can't use bobs and IFF files.  
  17.    Say you're writing a short program for a magazine,and
  18.    people will be typing in the listing themselves.  How
  19.    do you handle the bobs?  Now your program can draw them 
  20.    with art code and grab them with "Get Bob."
  21.   
  22.  
  23.    The other chief advantage of this approach is 
  24.    compactness.  Assuming a drawing of limited complexity, 
  25.    the art code tends to be much smaller than an IFF file 
  26.    of the same image.  Say you've got a title screen 
  27.    that's currently a 35k IFF file.  Trace it with the Art 
  28.    Coder and it may add 3k to your code, but you can get 
  29.    rid of the IFF file, for a net savings of 32k.  Or say 
  30.    you're writing an adventure game.  Using art code, your 
  31.    program could have 150 very different background images 
  32.    and still fit onto a single floppy disk.
  33.  
  34.    Art Coder is also ideal for designing interface screens
  35.    because you can refer to the X,Y coordinates of Box
  36.    and Bar commands in your art code when you're writing
  37.    the routines that check for mouse clicks.
  38.  
  39.  
  40.  USING THE AMOS ART CODER
  41.  
  42.    Run AMOS Pro or AMOS 1.3.  Load and run ArtCoder.AMOS.
  43.    The first time you run the program you will be asked to 
  44.    select a screen size and number of colors, then center 
  45.    the screen and click the mouse.  When a blank screen 
  46.    and a control panel appear, select a graphics mode 
  47.    (Polygon, Polyline, etc.), and a color.  Draw your 
  48.    picture, experimenting with different graphics modes 
  49.    and colors.  Note that the lines "rubber band" as long 
  50.    as the left mouse button is held down.  You can toggle 
  51.    the control panel on or off with the F10 key.  When you 
  52.    finish the picture, select Quit.  
  53.  
  54.  IMPORTANT:  Before merging your art code, look at the 
  55.    information line at the top of the editor screen, where 
  56.    it says "Free-" followed by a number.  If the number is 
  57.    less than 20,000, go to the Editor menu and select Set 
  58.    Text Buffer.  (In AMOS 1.3, use Alt-F9.)  Increase the 
  59.    number in the requester by at least 20,000.  Setting 
  60.    the number to 100,000 should give you plenty of room.
  61.    Click on Okay.
  62.  
  63.    Now locate the cursor beneath the seventh line of the 
  64.    program (under the comments) and merge the art code.
  65.    To do this in AMOS Professional, depress the Left 
  66.    Amiga, Shift, and M keys.  (In AMOS 1.3, use Shift-F5.)  
  67.    At the file requester, double click on "ArtCode.asc".  
  68.    The code to re-create your drawing will be inserted 
  69.    into the program.  Run the program again and watch it 
  70.    draw your picture.  
  71.  
  72.    If you've drawn something you'd like to use in one of 
  73.    your own programs, highlight the art code, store it, 
  74.    then paste it into that program.  Make sure the screen 
  75.    dimensions are compatible.
  76.  
  77.    The keyboard equivalents should be familiar to users of 
  78.    DPaint.  They are:
  79.  
  80.    D   Draw filled Polygon.  There's a 15-side limit to 
  81.        polygons, and a little counter appears near the 
  82.        upper left corner to help you keep track.  You can
  83.        tap the Space Bar to start a new polygon.
  84.  
  85.    d   Draw Polyline.  Draw continuous lines as if you 
  86.        were playing Connect-the-Dots.   The Space Bar 
  87.        starts a new polyline.
  88.  
  89.    v   Draw line segments.  
  90.  
  91.    r   Rectangular box.
  92.  
  93.    R   Rectangular bar (filled).
  94.  
  95.    f   Fill with paint.
  96.  
  97.    p   Palette.
  98.  
  99.    t   Text.
  100.  
  101.    Q   Quit.
  102.  
  103.    ,   Pick a color from the image, not the control 
  104.        panel.
  105.  
  106.    F10 Toggles control panel on and off.
  107.  
  108.    When the Outline box has a check by it, Bars and 
  109.    Polygons get drawn with an outline around them.  
  110.  
  111.    When the Pattern box has a check by it, Bars, Polygons 
  112.    and Paint get drawn with a pattern.  To turn the 
  113.    pattern off, set it to zero.  While the control bar is 
  114.    in pattern select mode, clicking on the color boxes 
  115.    changes the pattern color and leaves the main ink color 
  116.    unaffected.
  117.  
  118.    To create images that draw quickly, use mostly 
  119.    polygons, polylines, segments, boxes and bars. Circles 
  120.    and paint fills execute a lot more slowly.
  121.  
  122.    To change screen dimensions, quit and run Art Coder
  123.    again with the Shift key held down.
  124.  
  125.    Clever trick: you can add a "Load IFF" command where
  126.    the art code goes, and simply trace the picture.  The 
  127.    more realistic drawings in the sample slide show were
  128.    done this way.  You may have to stop periodically to
  129.    merge in your code above the "Load IFF" command, and
  130.    write a note to yourself about what's been traced
  131.    already.
  132.  
  133.    Sad development: OS 3.1 makes AMOS jump around like
  134.    crazy when you open an interlaced screen.  So, even
  135.    though Art Coder can handle laced screens, you should
  136.    avoid them in the name of compatibility with the Amiga's
  137.    latest operating system.
  138.  
  139.    Aesthetic advice: art code works best for large, bold
  140.    screens, not small detailed imagery.  If you try to put
  141.    too much detail in, the routines take too long to draw
  142.    and you could even end up exceeding the size of the
  143.    same picture in IFF format!  Think big and bold.
  144.  
  145.  
  146.  CALL FOR ARTISTS
  147.  
  148.    I'd like to put together a slide show of images done in
  149.    Art Coder by different AMOS users, and upload it
  150.    to Aminet.  If you'd like to participate, replace the
  151.    pictures in "SlideShow.AMOS" with some of your own and
  152.    send it to me either on an 880K floppy disk or UUencoded.
  153.    Images should be 352x240, 32 colors.  If there's a big
  154.    response, I'd like to make it unarchive to exactly fill
  155.    a floppy disk.  If the pictures have the same complexity
  156.    as the ones in the enclosed slide show, about 150 would
  157.    fit on an 880K floppy, once the program's compiled.  Be
  158.    sure to send your slide show as source code.
  159.  
  160.    Steve Tiffany
  161.    3255 14th Ave. So. #4      -or-   stiffany@isd.net
  162.    Minneapolis, MN  55407
  163.    USA                      (addresses current January 96)
  164.  
  165.